home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / cbv226.zip / CBV.DOC < prev    next >
Text File  |  1990-06-12  |  57KB  |  1,725 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                                     C B V
  27.  
  28.                                  Version 2.26
  29.                      Automated Call-Back Verifier System
  30.  
  31.                       Minnie's Software (901)873-2315
  32.                                  1:123/10
  33.  
  34.                       Copyright (C) 1989, Jim Baldwin
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                        CBV Version 2.26
  71.                        Copyright (C) 1989, Jim Baldwin
  72.  
  73.  
  74.           NOTE:  This manual may be  printed by running the REGISTER
  75.           program and selecting option 1 from the main menu.
  76.  
  77.           TABLE OF CONTENTS:
  78.  
  79.           Disclaimer....................................... 3
  80.           Introduction..................................... 4
  81.           Where to Reach the Author........................ 5
  82.           ACKNOWLEDGEMENTS................................. 6
  83.           Distribution..................................... 6
  84.           Requirements..................................... 6
  85.           The Shareware Concept............................ 7
  86.           How do I Register?............................... 7
  87.           Files Included in the Package.................... 9
  88.           Installation and Setup........................... 11
  89.           Adding CBV to Your QuickBBS Batch File........... 12
  90.           Modem Initialization String...................... 15
  91.           Setting up LOCAL.CTL............................. 16
  92.           Setting up CBV.CNF............................... 18
  93.           How it works..................................... 20
  94.           SYSTEM.LOG Message List.......................... 21
  95.           Notes, Hints, Tips, etc.......................... 23
  96.           Version History.................................. 24
  97.           Registration Form................................ 28
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                     Page 2
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.                        CBV Version 2.26
  135.                        Copyright (C) 1989, Jim Baldwin
  136.  
  137.  
  138.                                   DISCLAIMER
  139.                     NO WARANTEE ON CBV PROGRAMS OR MANUAL
  140.  
  141.           THIS SOFTWARE,  THE CBV  PROGRAMS AND  MANUAL, IS PROVIDED
  142.           "AS  IS"  WITHOUT  ANY  EXPRESSED  OR  IMPLIED  WARRANTIES
  143.           WHATSOEVER.  BECAUSE  OF THE  DIVERSITY OF  CONDITIONS AND
  144.           HARDWARE  UNDER  WHICH  THIS  SOFTWARE  MAY  BE  USED,  NO
  145.           WARRANTY OF FITNESS  FOR A PARTICULAR  PURPOSE IS OFFERED.
  146.           MINNIE'S SOFTWARE, OR JIM BALDWIN CANNOT BE HELD RESPONSIBLE
  147.           FOR DIRECT, INDIRECT, INCIDENTAL, CONCEQUENTAL,  OR OTHER
  148.           DAMAGES  DUE TO  YOUR  ABILITY OR INABILITY  TO USE  THIS
  149.           SOFTWARE,  EVEN  IF MINNIE'S SOFTWARE HAS BEEN ADVISED OF 
  150.           THE POSSIBILITY OF SUCH DAMAGES.   THE  USER  IS  ADVISED
  151.           TO TEST THIS SOFTWARE THOROUGHLY BEFORE RELYING ON IT AND
  152.           MUST ASSUME THE ENTIRE RISK OF USING THIS SOFTWARE.
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.                                     Page 3
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.                        CBV Version 2.26
  200.                        Copyright (C) 1989, Jim Baldwin
  201.  
  202.  
  203.                                  INTRODUCTION
  204.  
  205.               You're a sysop.  How do  YOU make sure each caller has
  206.           one and only  one account on your  system?  It wouldn't be
  207.           fair to  you or  the other  users for  one person  to have
  208.           access to more than one account on your system.  That user
  209.           could use up his time and download limits for one account,
  210.           then  call back  under his  second  account, or  third, or
  211.           fourth...
  212.               Most sysops  ask for  a phone  number when  a new user
  213.           creates an  account.  Then, the  Sysop, on his  or her own
  214.           time, attempts  to call the  user at the  number to verify
  215.           that the user actually exists  and that the supplied phone
  216.           number is correct.  If all  goes well, if the number isn't
  217.           busy, if the  user is at  home, if the  number is correct,
  218.           and  if the  user actually  did call  the board,  then the
  219.           Sysop takes a satisfying sigh of relief.
  220.               On  the  other  hand, some  Sysops  just  don't bother
  221.           anymore.  These Sysops  either pull the  plug, or just let
  222.           things run amuck.   Either way, it's a  painful death to a
  223.           potentially excellent BBS.
  224.               Wouldn't it  be nice  if you  could just  forget about
  225.           verifying users?   Wouldn't it  be nice  not to  have that
  226.           list of "phone numbers to verify" building up, waiting for
  227.           you to spare an  hour or two?  Do  you find, that when you
  228.           actually get down  to it and  start verifying the numbers,
  229.           that maybe  three-fourths are  phony? (pun  intended)  Are
  230.           you nodding your head yet?
  231.               ALONG COMES  CBV TO  YOUR RESCUE!   You don't  need to
  232.           verify  phone numbers  ANY  MORE!  Instead,  your computer
  233.           does it for you!  Leave the tedious stuff to the computer.
  234.               A  new user  will  log in,  and  run the  external CBV
  235.           program.  The CBV will check  the new user's phone numbers
  236.           against  the  phone  numbers  of  registered  users.  This
  237.           prevents a  user from  attempting the  have more  than one
  238.           valid  account.   The CBV  then  checks to  make  sure the
  239.           number is a local call (if it is a long distance call, the
  240.           user  will  be  instructed  on  an  alternate verification
  241.           method).  The CBV will then  disconnect, and after a short
  242.           delay, it will call the  user's number.  The user then has
  243.           his or her  computer answer the  phone, and when connected
  244.           is  requested  to  enter   his  password.   Once  this  is
  245.           completed  successfully, the  user is  immediately allowed
  246.           back on the board with new time limits and download limits
  247.           (if any).   Please note  that the  Call-Back Verifier will
  248.           only attempt to  dial a number ONCE.   This helps cut down
  249.           on any conceivable abuse.
  250.               The CBV system features:
  251.  
  252.               --ANSI  color and  screen  clearing (if  the  user has
  253.           those options enabled)
  254.               --SECURITY!  Many  months of  research and development
  255.           were spent on making the CBV system as secure as possible.
  256.               --Configurability
  257.  
  258.                                     Page 4
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.                        CBV Version 2.26
  266.                        Copyright (C) 1989, Jim Baldwin
  267.  
  268.  
  269.               --QuickBBS-like Status Line
  270.               --Directly  updates  the user's  security  level, time
  271.           left, and download limits.
  272.               --Makes   log   entries,    QuickBBS-style,   in   the
  273.           SYSTEM.LOG.
  274.               --Uses the FOSSIL driver.
  275.  
  276.               Nearly every aspect of the CBV system is configurable:
  277.               --Security levels before and after verification
  278.               --Flags given to users after verification
  279.               --Multiple local area codes (extended calling)
  280.               --Colors
  281.               --Local area code and prefixes
  282.               --Buffering
  283.               --Modem commands
  284.               --Much More!
  285.  
  286.               I have been running  the CBV system on  my own BBS for
  287.           several months now.   It is very pleasant  to just let the
  288.           system run on "auto-pilot"  for a few days  at a time.  My
  289.           time is freed up  now so that I  can participate more as a
  290.           user on my own BBS.
  291.               Another advantage to  the system is  that you may lock
  292.           out  any   phone  number,  preventing   anyone  from  ever
  293.           verifying successfully using that number.
  294.               Generally, new  users like  the CBV  system because it
  295.           only takes  a few minutes  to obtain normal  access to the
  296.           board, instead of  waiting for days or  even weeks for the
  297.           Sysop to verify users.  Most  users also like knowing that
  298.           every message left on the BBS is from a valid caller.
  299.  
  300.                           WHERE TO REACH THE AUTHOR
  301.  
  302.               I may be reached through;
  303.  
  304.                 FidoNet;    1:123/10
  305.  
  306.               I can be reached as Jim Baldwin on:
  307.  
  308.                   Minnie's Satellite BBS
  309.                   (901) 873-2315
  310.                   300/1200/2400/9600
  311.  
  312.               Finally, correspondence may be mailed to:
  313.  
  314.                   Jim Baldwin
  315.                   P.O. Box 70245
  316.                   Memphis, TN 38107
  317.  
  318.           The  latest version  can be  downloaded  from the BBS listed
  319.           above or HST 1:123/10, magic name: CBV.
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.                                     Page 5
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.                        CBV Version 2.26
  334.                        Copyright (C) 1989, Jim Baldwin
  335.  
  336.  
  337.                                ACKNOWLEDGEMENTS
  338.  
  339.  
  340.  
  341.           First, I  would like  to thank  Geoff Shepard  for authoring
  342.           such a useful program in the first place.  Also Adam Hudson
  343.           for writing such a good BBS program and then the QuickBBS 
  344.           Group for suporting it.
  345.  
  346.           I also thank Jeff Stewart, Joel Bergen, and especially the
  347.           ever-persistent Bill Castle for their invaluable time and
  348.           encouragement.
  349.  
  350.           Thanks  to  those  who register,  and  to  those  who give
  351.           suggestions and comments.
  352.  
  353.           QuickBBS is copyrighted by Adam Hudson.
  354.  
  355.  
  356.                                  DISTRIBUTION
  357.  
  358.           This software may be freely distributed, as long as all of
  359.           the following conditions are satisfied:
  360.  
  361.           1.   No fee  is charged  for  such distribution  except to
  362.           compensate  for  the  cost  of  the  disks,  shipping, and
  363.           handling (not to  exceed $5 total).   This software may be
  364.           distributed through on-line subscription services.
  365.  
  366.           2.  The entire  system is distributed  as a whole, without
  367.           modifications.
  368.  
  369.           3.  The software is not bundled with any other package.
  370.  
  371.           4.   Version  2.26  must remain  in  .ZIP  format,  and the
  372.           ZIP-file comment must not be modified.
  373.  
  374.           Please immediately inform  the author or  Jim Baldwin of
  375.           any violations of these conditions.
  376.  
  377.                                  REQUIREMENTS
  378.  
  379.           QuickBBS, version 2.03 or later.
  380.           MS-DOS 2.1 or later.
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.                                     Page 6
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.                        CBV Version 2.26
  400.                        Copyright (C) 1989, Jim Baldwin
  401.  
  402.  
  403.                             THE SHAREWARE CONCEPT
  404.  
  405.               This software  is distributed  through the "ShareWare"
  406.           concept,  a   try-before-you-buy  arrangement.    You  are
  407.           allowed to use the software for a short evaluation period,
  408.           after  which,  you  must  either  register  your  copy  or
  409.           discontinue using the software.
  410.               Your  FULLY  FUNCTIONAL  evaluation  copy  has several
  411.           built-in reminders that it is for evaluation use only:
  412.               1.   When  the  software  is  run,  a  notice  will be
  413.           displayed both  locally and  to the  remote user  that the
  414.           software  is an  evaluation copy  only; the  serial number
  415.           will also  be displayed.  After  a five  second pause, the
  416.           program will continue.
  417.               2.  When the software  is run, a note  will be made in
  418.           the QuickBBS log that the software is for evaluation only.
  419.               3.  Another reminder  will flash at  the bottom of the
  420.           screen during  use.  If in  local mode,  the reminder will
  421.           stop  flashing at  the  first prompt.   The  reminder will
  422.           constantly flash in non-local mode.
  423.               Yes, these reminders were designed to be annoying, but
  424.           not  overly  distracting.  The  evaluation  copy  is fully
  425.           functional.  No specific features have been disabled.
  426.  
  427.                               HOW DO I REGISTER?
  428.  
  429.               Registering your copy of the CBV system is EASY!  Just
  430.           run the  REGISTER program  from DOS  (you must  be in your
  431.           QuickBBS directory), and pick option 2, which will ask you
  432.           several  questions  and  finally  generate  a REGISTRATION
  433.           FORM, automatically filling  in the pertinent information.
  434.           You may  then have  the form  printed on  your printer, or
  435.           saved as an ASCII file.  To make registration even easier,
  436.           you   may  select   to   have  a   self-mailer  generated.
  437.           Instructions  for  folding the  pre-addressed  mailer will
  438.           also be printed.
  439.               BEFORE REGISTERING, make sure  that the "Sysop's Name"
  440.           entry in  QCONFIG (configuration  for QuickBBS)  is set to
  441.           your name  or an  alias that you  will stick  to.  If, for
  442.           some reason, you change that name after receiving your CBV
  443.           registration  number, you  will  need to  purchase another
  444.           registration  number.   Thus, I  suggest  using  your real
  445.           name.
  446.               Registration costs  just $8  (plus 7.75%  sales tax for
  447.           Tenneesee  State residents).   After registering, you will
  448.           receive a  special REGISTRATION  NUMBER that  when used in
  449.           conjunction  with the  REGISTER  program, will  remove the
  450.           evaluation  copy  reminders.   This  special  registration
  451.           number  will  work with  all  future releases  of  the CBV
  452.           system.  Your  name will  also be  on our  mailing list so
  453.           that you  will receive notices  in the  mail regarding any
  454.           updates  or  other  pertinent  information  about  the CBV
  455.           package  and  other products  and  services  from Computer
  456.           Deli.  Finally,  and this is  optional, you  can have your
  457.  
  458.                                     Page 7
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                        CBV Version 2.26
  466.                        Copyright (C) 1989, Jim Baldwin
  467.  
  468.  
  469.           name,  BBS name  and  BBS number  entered  on the  list of
  470.           supporting users for future releases of the documentation.
  471.               So, play with  the system for  a few days,  and if you
  472.           like it,  REGISTER IT!   Registration is  easy, maybe even
  473.           fun, and it might even cure your acne!
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.                                     Page 8
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.                        CBV Version 2.26
  532.                        Copyright (C) 1989, Jim Baldwin
  533.  
  534.  
  535.                         FILES INCLUDED IN THE PACKAGE
  536.  
  537.           Below  is a  list of  the files  included in  the package,
  538.           their descriptions,  and where  they should  be located on
  539.           your  hard   drive.   Note  that   INSTALL.BAT  creates  a
  540.           subdirectory  called "CBVFILES"  below the  directory that
  541.           the system was installed  from.  INSTALL also copies these
  542.           files to their  appropriate directories.  QBBSBAT?.TXT and
  543.           SURVEY.Q-A  are  not  copied,  but  left  in  the CBVFILES
  544.           directory.
  545.  
  546.           Modify any of the following  batch files to work with your
  547.           system, if you  like.  See the batch  file section of this
  548.           manual.
  549.  
  550.           QBBSBAT1.TXT  Sample QuickBBS batch file incorporating the
  551.                         CBV  handler  for  a  non-networked QuickBBS
  552.                         system.   This  batch may  run  fine without
  553.                         modification.
  554.           QBBSBAT2.TXT  Sample QuickBBS batch file incorporating the
  555.                         CBV handler for a networked QuickBBS.
  556.           QBBSBAT3.TXT  Sample QuickBBS batch  file I use  on my own
  557.                         system.
  558.  
  559.           These  files go  into  your "text  file"  subdirectory for
  560.           QuickBBS:
  561.  
  562.           CBV1.ASC      User Manual:  Overview
  563.           CBV2.ASC      User Manual:  Why CBV?
  564.           CBV3.ASC      User Manual:  Instructions
  565.           CBV4.ASC      User Manual:  Getting Your Modem to Answer
  566.                                       the Phone
  567.           CBV5.ASC      User Manual:  About the CBV Program
  568.  
  569.           SEC5.ASC \    File seen by non-verified user at logon that
  570.           SEC5.ANS /    informs the user of limited access and how
  571.                         to verify himself.
  572.  
  573.           These files go into your main QuickBBS subdirectory:
  574.           CBV.CNF       Configuration File
  575.           LOCAL.CTL     Local Prefix File
  576.           CBV.EXE       The CBV program to be called from QBBS.BAT
  577.           REGISTER.EXE  The CBV REGISTRATION program to be run from
  578.                         DOS
  579.           SURVEY.Q-A    Sample new-user survey (assumes flag A8 is
  580.                         defaults to ON for new users)
  581.  
  582.           These files go  into your main  QuickBBS subdirectory, NOT
  583.           your text subdirectory:
  584.  
  585.           CBV.TXT       The file first seen when CBV is run
  586.           CBVDIST.TXT   File displayed if user is long distance
  587.           CBVDONE.TXT   File displayed once verification is complete
  588.           CBVDUPE.TXT   File displayed if duplicate phone number
  589.  
  590.                                     Page 9
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.                        CBV Version 2.26
  598.                        Copyright (C) 1989, Jim Baldwin
  599.  
  600.  
  601.           CBVLAST.TXT   File displayed before last chance to abort
  602.           CBVLOGIN.TXT  File   displayed  when   reconnected  again,
  603.                         before password is requested
  604.           CBVWRONG.TXT  File displayed if user determines his or her
  605.                         phone number(s) are incorrect
  606.  
  607.           These files go into your QuickBBS "Menus" subdirectory:
  608.           CBV.MNU       Sample CBV menu to be called from TOP menu.
  609.           CBVMAN.MNU    Menu for CBV User Manual (table of contents)
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.                                     Page 10
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.                        CBV Version 2.26
  664.                        Copyright (C) 1989, Jim Baldwin
  665.  
  666.  
  667.                             INSTALLATION AND SETUP
  668.  
  669.               This  section  presents  step-by-step  instructions on
  670.           setting up the CBV system.   Put a check-mark in the boxes
  671.           as you go so that you don't accidentally skip a step.
  672.  
  673.  
  674.           [ ] 1.  Edit  the  CBV.CNF configuration  file  using your
  675.                   favorite  ASCII text  editor.   Brief instructions
  676.                   are contained  in the  file itself.   See also the
  677.                   CBV.CNF section of this manual.
  678.  
  679.           [ ] 2.  Edit  the  LOCAL.CTL.   This  file  should contain
  680.                   prefixes and area codes that  you can call free of
  681.                   charge.  See the LOCAL.CTL section of this manual.
  682.  
  683.           [ ] 3.  Edit any of  the CBV*.TXT files.   At least change
  684.                   the  name  to  that  of  your  BBS.   If  you  are
  685.                   clarifying something, please let me know so that I
  686.                   may   incorporate   the   change(s)   into  future
  687.                   releases.  In  these files (.TXT),  you may insert
  688.                   special "escape" sequences:
  689.                   ~n    Normal color    \   These only have effect
  690.                   ~h    High intensity   >- if the user has ANSI
  691.                   ~a    Alternate color /   enabled.
  692.  
  693.                   ~c    Clear screen    --- Only works if user has
  694.                                             screen clearing enabled.
  695.  
  696.                   The actual colors the ~n, ~h, and ~a sequences set
  697.                   are determined by settings in the CBV.CNF file.
  698.  
  699.           [ ] 4.  Edit any of  the "User Manual"  files if you wish.
  700.                   As with step 4, let  me know if you are clarifying
  701.                   anything.  You may want to create ANSI versions of
  702.                   these  files.  The  escape  sequences used  in the
  703.                   .TXT files mentioned  in step 4  cannot be used in
  704.                   these files.
  705.  
  706.           [ ] 5.  Edit the CBV.MNU (and  if you want, the CBVMAN.MNU
  707.                   also) to suit the style of your system.  Note that
  708.                   these  menus  are automatically  copied  into your
  709.                   MENUS directory.  There is  no need to create your
  710.                   own  CBV  menus  from  scratch.   Just  patch  the
  711.                   CBV.MNU into your TOP.MNU or wherever you see fit.
  712.  
  713.           [ ] 6.  Add an option  to your TOP  menu, or whatever menu
  714.                   you  prefer, to  access the  CBV.MNU menu.   On my
  715.                   system, it is:
  716.                   <N>ew User Verification and Survey
  717.                   on my Utilities menu.
  718.                   Use a  menu type  2 to  "gosub" the  CBV menu.  It
  719.                   provides an option to return to the previous menu.
  720.  
  721.  
  722.                                     Page 11
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.                        CBV Version 2.26
  730.                        Copyright (C) 1989, Jim Baldwin
  731.  
  732.  
  733.           [ ] 7.  Edit  or discard  the  SURVEY.Q-A sample  new user
  734.                   questionnaire.   After the  user has  answered it,
  735.                   flag A8 is turned off.  I use that flag to display
  736.                   a little reminder  that the user  has not answered
  737.                   the questionnaire yet.
  738.  
  739.           [ ] 8.  Add the CBV system call  to the batch file you use
  740.                   to run  QuickBBS, which is  the topic  of the next
  741.                   section.
  742.  
  743.           That is  it as far  as setting it  up (I make  it sound so
  744.           easy don't I?  -grin-)...
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.                                     Page 12
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.                        CBV Version 2.26
  796.                        Copyright (C) 1989, Jim Baldwin
  797.  
  798.  
  799.                     ADDING CBV TO YOUR QUICKBBS BATCH FILE
  800.  
  801.               Adding  the CBV  system  to your  QuickBBS  batch file
  802.           isn't the easiest  thing to explain due  to the variety of
  803.           setups.   I  have include  several  sample  QuickBBS batch
  804.           files, QBBSBAT?.TXT, in  the package, and  I have included
  805.           two examples  here:  one  for systems  running a front-end
  806.           mailer, and one for stand-alone systems.
  807.               One quick note about  the CBV system itself.  QuickBBS
  808.           ABSOLUTELY MUST  EXIT with  a type  15 command  to run the
  809.           CBV, >NOT< a type 7  command.  This is VERY IMPORTANT.  If
  810.           you try to use  a type 7 command, CBV  will not be able to
  811.           modify the user's  security level and  limits.  If you are
  812.           using the  CBV.MNU menu that  came with  this package, you
  813.           will notice  that it does  a type 15  exit with errorlevel
  814.           10.
  815.  
  816.  
  817.           Example 1 - for systems NOT running a front-end mailer.
  818.  
  819.           :start
  820.           quickbbs
  821.           if errorlevel 10 goto cbv
  822.           goto quit
  823.  
  824.           :restart
  825.           quickbbs -r -e0
  826.           rem The -e0 forces QuickBBS to exit when the caller
  827.           rem terminates.  This is needed for proper operation.
  828.           if errorlevel 10 goto cbv
  829.           goto start
  830.  
  831.           :cbv
  832.           cbv
  833.           if errorlevel 1 goto restart
  834.           goto start
  835.  
  836.           :quit
  837.  
  838.  
  839.           Example 2 - For systems running a front-end mailer.
  840.  
  841.           :start
  842.           mailer
  843.           if errorlevel 24 goto 2400
  844.           if errorlevel 12 goto 1200
  845.           if errorlevel 3 goto 300
  846.           if errorlevel 1 goto local
  847.           goto quit
  848.  
  849.           :2400
  850.           quickbbs -b2400 -e0
  851.           if errorlevel 10 goto cbv
  852.           goto start
  853.  
  854.                                     Page 13
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.                        CBV Version 2.26
  862.                        Copyright (C) 1989, Jim Baldwin
  863.  
  864.  
  865.  
  866.           :1200
  867.           quickbbs -b1200 -e0
  868.           if errorlevel 10 goto cbv
  869.           goto start
  870.  
  871.           :300
  872.           quickbbs -b300 -e0
  873.           if errorlevel 10 goto cbv
  874.           goto start
  875.  
  876.           :local
  877.           quickbbs -l -e0
  878.           if errorlevel 10 goto cbv
  879.           goto start
  880.  
  881.           :restart
  882.           quickbbs -r -e0
  883.           if errorlevel 10 goto cbv
  884.           goto start
  885.  
  886.           :cbv
  887.           cbv
  888.           if errorlevel 1 goto restart
  889.           goto start
  890.  
  891.           :quit
  892.  
  893.           If you need help in  modifying your batch files, you might
  894.           try seeking the help of one of your local DOS and QuickBBS
  895.           gurus.  Also, I have a "CBV Questions and Answers" message
  896.           section available on  my board (open  to all callers, even
  897.           new callers).
  898.  
  899.           Basically,  after  the  board  exits,  the  errorlevel  is
  900.           checked  (remember  that errorlevels  must  be  checked in
  901.           reverse  order, ie  4,3,2,1).   If the  errorlevel  is 10,
  902.           control jumps to the  CBV section.  CBV returns errorlevel
  903.           0 if the connection was lost or terminated, and errorlevel
  904.           1 if  QuickBBS should  be restarted  (-r) to  let the user
  905.           back  online  without  dropping  the  connection.   If the
  906.           errorlevel  is 1,  then it's  ok  to restart  QuickBBS, so
  907.           control jumps to the RESTART  label, and the errorlevel is
  908.           checked again.  Otherwise, it  jumps back to start.  Those
  909.           are the  major elements to  cover in  modifying your batch
  910.           file.
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.                                     Page 14
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.                        CBV Version 2.26
  928.                        Copyright (C) 1989, Jim Baldwin
  929.  
  930.  
  931.                          MODEM INITIALIZATION STRING
  932.  
  933.               The  modem  default modem  initialization  string that
  934.           comes with the CBV package in the CBV.CNF file is:
  935.  
  936.           ATZ|~~ATE0M1Q0V0X4S0=0S7=45|~~
  937.  
  938.           In all configurable modem commands:
  939.             ~ = 1/2 second pause (500 msec)
  940.             | = Carriage Return (Enter)
  941.  
  942.           The init  modem command  MUST set  up the  modem to return
  943.           numeric result codes  (Q0V0), and the  modem MUST NOT echo
  944.           the commands back to the computer (E0).  Dropping DTR MUST
  945.           force to modem  to disconnect.  The  modem MUST return the
  946.           true  state of  carrier  detect.  Some  modems  have small
  947.           switches (dip switches)  to select some  of these options,
  948.           while some modems have actual commands for these settings.
  949.  
  950.           If you have problems  with the CBV and  your modem, or the
  951.           CBV acts erratically, you might try setting TxDelay in the
  952.           CBV.CNF file to  a higher value  to slow down  the rate at
  953.           which commands  are sent to  the modem.   Also, try adding
  954.           more pauses (~'s) after the ATZ| in the init string.
  955.  
  956.           The Xn (where n  is a number from  0 through 9) determines
  957.           which  result  codes  your modem  returns,  such  as BUSY,
  958.           VOICE, RINGING,  etc.  X4 should  work in  most cases, but
  959.           see your modem  manual for a  list of Xn  commands and the
  960.           corresponding enabled result codes.  Generally, it is best
  961.           to have as many result codes enabled as possible.
  962.  
  963.           S7=nn determines in  seconds how long  the modem will wait
  964.           for the other end to answer.
  965.  
  966.           Mn controls  the modem  speaker: 0=always  off, 1=on until
  967.           connection, 2=always on.
  968.  
  969.               For  HST  modems, change  X4  to X6  in  the ModemInit
  970.           command.
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.                                     Page 17
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.                        CBV Version 2.26
  994.                        Copyright (C) 1989, Jim Baldwin
  995.  
  996.  
  997.                              SETTING UP LOCAL.CTL
  998.  
  999.               LOCAL.CTL  list  all   area  codes  and  corresponding
  1000.           prefixes   that  are   local   calls  from   your  system.
  1001.           Generally, setup is straight forward, although it may be a
  1002.           bit more involved if you have multiple local area codes or
  1003.           extended calling.  Consult your  telephone book for a list
  1004.           of area codes  and prefixes that are  local calls.  If you
  1005.           have  many  prefixes  to  enter,  you  may  find  it  more
  1006.           convenient to use your numeric keypad.
  1007.  
  1008.           Definition - Parts of a telephone number:
  1009.  
  1010.           aaa-bbb-cccc
  1011.  
  1012.           aaa = area code
  1013.           bbb = prefix
  1014.           ccc = postfix
  1015.  
  1016.             IF YOU HAVE JUST ONE AREA CODE AND A SPECIFIC LIST OF
  1017.                         PREFIXES THAT ARE LOCAL CALLS:
  1018.  
  1019.               Set your area code at the top of the LOCAL.CTL file as
  1020.           follows:
  1021.  
  1022.           *nnn
  1023.  
  1024.           The asterisk (*) must be  the first character on the line,
  1025.           and nnn is your area code (i.e. 206, 414, etc).
  1026.  
  1027.               On  the  lines  following  the  area  code,  list  all
  1028.           prefixes that  are local  calls, one  to a  line.  Use the
  1029.           special  prefix, "ALL"  (without  the quotes)  to indicate
  1030.           that all prefixes in a  specific area code are local.  Use
  1031.           this option with caution.
  1032.  
  1033.               A  default LOCAL.CTL  is provided  and copied  to your
  1034.           QuickBBS directory.   The sample  LOCAL.CTL is  set up for
  1035.           Everett, Washington prefixes in area code 206.  It is easy
  1036.           to modify the file to your own area.
  1037.  
  1038.              IF YOU HAVE SEVERAL AREA CODES, EACH WITH A LIST OF
  1039.                         PREFIXES THAT ARE LOCAL CALLS:
  1040.  
  1041.               This is also  known as "Extended  Calling."  There are
  1042.           two ways  of dialing numbers  outside your  own area code.
  1043.           The first is just to  dial the 7-digit number normally (as
  1044.           in 555-1234).  The second way is to dial the area code and
  1045.           the  number  (as in  206-555-1234).   Extended  Calling is
  1046.           different from long distance  calling in that the Extended
  1047.           Calling  areas  are  considered  local  calls,  where long
  1048.           distance  calls   (1-xxx-xxx-xxxx)  incur   long  distance
  1049.           charges.  The CBV system WILL NOT make long-distance calls
  1050.           (and the reason should be obvious)!
  1051.  
  1052.                                     Page 18
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.                        CBV Version 2.26
  1060.                        Copyright (C) 1989, Jim Baldwin
  1061.  
  1062.  
  1063.  
  1064.               Set up the LOCAL.CTL file as follows:
  1065.  
  1066.               Start with your first area  code.  List it with either
  1067.           an asterisk (*) or an @ sign in front as in:
  1068.  
  1069.           *206
  1070.           -or-
  1071.           @206
  1072.  
  1073.               The asterisk indicates that the  area code need NOT be
  1074.           dialed  before  the  number   (as  in  555-1234).   The  @
  1075.           indicates that  the area  code MUST  be dialed  before the
  1076.           number (as in 206-555-1234).
  1077.               After  the area  code,  list all  local  prefixes that
  1078.           belong to that area code, one to a line.  You may list the
  1079.           special prefix, "ALL" (without the quotes) if all prefixes
  1080.           in a specific  area code are local.   Use this option with
  1081.           caution.
  1082.               Continue  with  your  next   area  code,  listing  its
  1083.           prefixes, and the next area code, etc.
  1084.  
  1085.           EXAMPLE OF LOCAL.CTL FOR EXTENDED CALLING:
  1086.  
  1087.           ;beginning of file
  1088.  
  1089.           *206
  1090.           252
  1091.           355
  1092.           335
  1093.  
  1094.           @414
  1095.           233
  1096.           744
  1097.           972
  1098.  
  1099.           @813
  1100.           ALL
  1101.  
  1102.           *318
  1103.           745
  1104.           382
  1105.  
  1106.           ;END OF FILE
  1107.  
  1108.           This indicates  that prefixes  252, 355,  and 335  in area
  1109.           code  206 are  local.  The  area code  need not  be dialed
  1110.           before the  number.  Prefixes  233, 744,  and 872  in area
  1111.           code  414 are  local,  and the  area  code must  be dialed
  1112.           before  the number.   All prefixes  in  area code  813 are
  1113.           local, and the area code must be dialed before the number.
  1114.           Prefixes 745 and 382  in area code 318  are local, and the
  1115.           area code need not be dialed before the number.
  1116.  
  1117.  
  1118.                                     Page 19
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.                        CBV Version 2.26
  1126.                        Copyright (C) 1989, Jim Baldwin
  1127.  
  1128.  
  1129.                               SETTING UP CBV.CNF
  1130.  
  1131.               INSTALL automatically  copies the  configuration file,
  1132.           CBV.CNF, to your QuickBBS directory.  The file should need
  1133.           little modification for most setups, with exception of the
  1134.           modem section.   The file has  explanatory comments before
  1135.           each keyword.  Just edit the file with your favorite ASCII
  1136.           text  editor.   In  the   interest  of  thoroughness,  the
  1137.           following  is   an  alphabetical   listing  of  acceptable
  1138.           keywords in the CBV.CNF file:
  1139.  
  1140.           (NOTE,  Command format for CBV.CNF file is:
  1141.            KeyWord   Value
  1142.            Neither  KeyWord nor  Value may  contain any  spaces, but
  1143.            Value must  be separated from  KeyWord with  at least one
  1144.            space or tab.   KeyWord must begin on  a new line.  Value
  1145.            may be optional, or may be a decimal number, or may be an
  1146.            ASCII string of characters)
  1147.  
  1148.           Alternate       Decimal, foreground color  for ~a sequence
  1149.                           in CBV????.TXT files.
  1150.           BufferOutput    Buffers  output for  multitasking systems,
  1151.                           leave out or comment out to disable output
  1152.                           buffering.  No Value.
  1153.           HangupDelay     Length  in   milliseconds  (1000msec=1sec)
  1154.                           modem will wait with  phone off hook after
  1155.                           disconnecting.  Suggested Value is 7000.
  1156.           High            Decimal, foreground color  for ~h sequence
  1157.                           in CBV???.TXT files.
  1158.           MaskA           MaskA  through  MaskD are  applied  to the
  1159.                           corresponding     user      flags     upon
  1160.                           verification,  and  only   if  the  user's
  1161.                           security  level  is  updated.   Format for
  1162.                           Value:
  1163.                           8-character string:
  1164.                           X = turn flag on
  1165.                           - = turn flag off
  1166.                           ? = leave flag alone
  1167.                           Example:
  1168.                           Userflag Before verification:  XXXX----
  1169.                           Mask........................:  X-?X-?X-
  1170.                           Userflag after verification.:  X-XX--X-
  1171.                           Leave   as    all   question    marks   or
  1172.                           comment/leave   out   to   disable.    See
  1173.                           NewUserSec.
  1174.           MaskB
  1175.           MaskC
  1176.           MaskD
  1177.           MemberSec       Decimal   level  given   to   users  after
  1178.                           successful verification.  See NewUserSec.
  1179.           ModemBaud       Baud rate to communicate  to modem at.  If
  1180.                           you have  a 2400  baud modem,  set this to
  1181.                           2400,  etc.  Has  no  effect if  FOSSIL is
  1182.                           locked for high-speed modems.
  1183.  
  1184.                                     Page 20
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.                        CBV Version 2.26
  1192.                        Copyright (C) 1989, Jim Baldwin
  1193.  
  1194.  
  1195.           ModemDial1      Command sent  before number  to make modem
  1196.                           dial.     In    ModemDial1,    ModemDial2,
  1197.                           ModemInit,   and   ModemOffHook,   special
  1198.                           commands  may be  embedded in  the command
  1199.                           string:
  1200.                           | = Carriage Return (Enter)
  1201.                           ~ = 1/2 second delay (500 msec)
  1202.           ModemDial2      Command  sent  to  modem  after  number to
  1203.                           dial.
  1204.           ModemInit       Command send to  modem to initialize.  See
  1205.                           the Modem Initialization String section of
  1206.                           this manual.
  1207.           ModemOffHook    Command to take modem off-hook.
  1208.           NewUserSec      Level   given   to    new   users   before
  1209.                           verification.        Upon       successful
  1210.                           verification, if the user's security level
  1211.                           equals MemberSec, then the user's security
  1212.                           level  is  updated  to  MemberSec  and the
  1213.                           user's  flags   are  subjected   to  MaskA
  1214.                           through MaskD.
  1215.           Normal          Decimal, foreground color  for ~n sequence
  1216.                           in CBV????.TXT files.
  1217.           Port            FOSSIL port to communicate with modem.
  1218.           ResumeQBBS      Comment/leave out  to force  CBV to always
  1219.                           exit  with errorlevel  0.   Otherwise, CBV
  1220.                           will exit  with errorlevel 1  when user is
  1221.                           still online and errorlevel 0 when user is
  1222.                           not  online.  QuickBBS  should  resume (-r
  1223.                           -e0)  when  CBV exits  with  errorlevel 1.
  1224.                           See the batch file section of this manual.
  1225.                           No Value.
  1226.           TxDelay         Delay  in  milliseconds   to  wait  before
  1227.                           sending  each   character  of   any  modem
  1228.                           command    strings.     See    the   Modem
  1229.                           Initialization  String   section  of  this
  1230.                           manual.
  1231.  
  1232.           CheckNumber     If present, CBV will check the phone
  1233.                           number(s) according to the US digit formats.
  1234.                           We suggest you add this keyword to CBV.CNF.
  1235.  
  1236.           DupeCheck n     Configures duplicate number checking.
  1237.                           n is one of the following:
  1238.                           0   (do not check for duplicates)
  1239.                           1   (check only the called number)
  1240.                           2   (check both numbers)
  1241.  
  1242.                           We suggest using either
  1243.                           DupeCheck 2 -or- DupeCheck 1
  1244.  
  1245.           CodeWord        If present in CBV.CNF, CBV will generate a
  1246.                           random CODEWORD before the caller is disconnected.
  1247.                           The caller must writedown the code word, and
  1248.                           re-enter it before proceeding.  When reconnecting
  1249.                           for verification, the caller must enter the
  1250.                           CODEWORD in addition to the login password.
  1251.                           This feature has two functions:  it effectively
  1252.                           disables script files, and it provides more
  1253.                           security to prevent "pre-arranged" verification.
  1254.  
  1255.  
  1256.                                     Page 21
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.                        CBV Version 2.26
  1264.                        Copyright (C) 1989, Jim Baldwin
  1265.  
  1266.  
  1267.                                  HOW IT WORKS
  1268.  
  1269.               When the new user logs into  your system, he or she is
  1270.           given a specific security level and flag settings.  At his
  1271.           leisure, he  can go  to the CBV  menu and  execute the CBV
  1272.           program.  QuickBBS exits to  DOS with a special errorlevel
  1273.           (defaults to 10 on the supplied CBV.MNU).  This errorlevel
  1274.           is  tested  in  the  QuickBBS  batch  file.   Control then
  1275.           branches to  the CBV section  of the batch  file.  The CBV
  1276.           program then executes.
  1277.  
  1278.           1.  CBV.CNF is read by the CBV system.
  1279.           2.  EXITINFO.BBS is examined to determine the settings.
  1280.           3.  CBV.TXT is displayed.
  1281.           4.  If the  caller has two  phone numbers, he  is asked to
  1282.           choose the one he is calling  from.  If the caller has one
  1283.           number, he is asked to press Enter.
  1284.           5.  The user is then asked if his phone number(s) and name
  1285.           are correct.  If he  answers no, CBVWRONG.TXT is displayed
  1286.           and CBV  exits with errorlevel  1, which is  tested in the
  1287.           batch file  and restarts QuickBBS  to let  the caller back
  1288.           online without loosing the connection.
  1289.           6.  If  he answers  yes, CBV  checks the  phone number for
  1290.           validity by applying a set  of rules.  If the phone number
  1291.           is invalid, a  note is made in  the SYSTEM.LOG and control
  1292.           is passed back to QuickBBS as above.
  1293.           7.  The phone number is then checked against the LOCAL.CTL
  1294.           file to make sure it is a  local call.  If the call is not
  1295.           local,  a  note  is  made  in  SYSTEM.LOG,  CBVDIST.TXT is
  1296.           displayed and control is passed back to QuickBBS.
  1297.           8.   The phone  number is  then  checked against  the user
  1298.           database.  If there is already a verified user or a locked
  1299.           out user  with the  same phone number,  a note  is made in
  1300.           SYSTEM.LOG,  CBVDUPE.TXT  is  displayed,  and  control  is
  1301.           passed back to QuickBBS.
  1302.           9.  CBVLAST.TXT  and the  phone number  are displayed, and
  1303.           the user  is given one  last chance to  abort the process.
  1304.           If the  user chooses to  abort, control is  passed back to
  1305.           QuickBBS.
  1306.           10.  CBV then disconnects the user.
  1307.           11.  After a short  delay, CBV calls the  user back at the
  1308.           specified phone number and waits to connect.
  1309.           12.  If,  for some  reason, no  connection takes  place, a
  1310.           note is made in the SYSTEM.LOG and the QuickBBS batch file
  1311.           recycles to the beginning.
  1312.           13.  Once  connected, the CBV  asks the user  to enter his
  1313.           logon password.  After three  incorrect tries, the user is
  1314.           hung up,  a note is  made in SYSTEM.LOG,  and the QuickBBS
  1315.           batch file recycles.
  1316.           14.  If the correct password is given, the user's security
  1317.           and flags are  updated.  Any new  time and download limits
  1318.           are granted, a note is  made in SYSTEM.LOG, and control is
  1319.           passed back to QuickBBS.
  1320.  
  1321.  
  1322.                                     Page 22
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.                        CBV Version 2.26
  1330.                        Copyright (C) 1989, Jim Baldwin
  1331.  
  1332.  
  1333.                            SYSTEM.LOG MESSAGE LIST
  1334.  
  1335.               CBV  logs  activity in  the  QuickBBS  SYSTEM.LOG file
  1336.           using the same format as QuickBBS itself.  You may see any
  1337.           of the following messages in the SYSTEM.LOG file:
  1338.  
  1339.           ######################################################
  1340.           ##  CBV EVALUATION COPY -- REGISTRATION IS ONLY $8! ##
  1341.           ##  RUN THE REGISTER PROGRAM TO REGISTER YOUR COPY. ##
  1342.           ######################################################
  1343.               Yet another reminder.
  1344.  
  1345.           User off-line.
  1346.               The user logged off or hung-up.
  1347.  
  1348.           User verification successful!
  1349.               The user verified successfully.
  1350.  
  1351.           User name/phone incorrect?
  1352.               The  user answered  <N>o to  the second  prompt, which
  1353.           asks if the information is correct.
  1354.  
  1355.           Duplicate phone number(s)!
  1356.               The user attempted to verify,  but a verified user was
  1357.           found in the user base with  one or both of the same phone
  1358.           numbers.
  1359.  
  1360.           User is long-distance -- Cannot Verify
  1361.               User has either a different  area code or a prefix not
  1362.           listed in LOCAL.CTL.
  1363.  
  1364.           Verifying user at XXX-XXXX
  1365.               CBV is dialing the indicated number.
  1366.  
  1367.           Verifying user at xxxx baud
  1368.               Reconnected at specified baud-rate.
  1369.  
  1370.           Error -- Verification Failed!
  1371.               BEWARE of ANY user that causes this message.
  1372.  
  1373.           Busy -- Verification Failed!
  1374.               Attempted to call user back, but phone was busy.
  1375.  
  1376.           Ringing...
  1377.               Ringing tone  detected (some modems  will provide that
  1378.           information, some will not).
  1379.  
  1380.           Voice Answer -- Verification Failed!
  1381.               For modems  that can  detect a non-modem/non-telephone
  1382.           sound, this indicates that  someone answered the call-back
  1383.           voice.  Keep an eye on anyone that causes this error.
  1384.  
  1385.           No Answer [n] -- Verification Failed!
  1386.               Non-recognized   modem  result   code   received  (n).
  1387.  
  1388.                                     Page 23
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.                        CBV Version 2.26
  1396.                        Copyright (C) 1989, Jim Baldwin
  1397.  
  1398.  
  1399.           Usually means modem timed out without receiving carrier.
  1400.  
  1401.           Invalid verification password "xxxxxxxx"
  1402.               User did not enter correct logon password.
  1403.  
  1404.           Invalid password -- Verification Failed!
  1405.               User  did not  enter  password correctly  within three
  1406.           tries.
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.                                     Page 24
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.                        CBV Version 2.26
  1462.                        Copyright (C) 1989, Jim Baldwin
  1463.  
  1464.  
  1465.                            NOTES, HINTS, TIPS, ETC
  1466.  
  1467.               One of  the great advantages  of running  with the CBV
  1468.           system, is  that if  you want to  REALLY lock  a user out,
  1469.           just stick their phone number(s) in the PHONENUM.CTL file.
  1470.           Nobody will be  able to log in  using those phone numbers,
  1471.           thus they won't be able to verify successfully!
  1472.  
  1473.               Note that  HST modems  may output  a burst  of garbage
  1474.           upon connection.
  1475.  
  1476.               The CBV  may be tested  in local  operation by logging
  1477.           onto the BBS locally and running the CBV system.  CBV will
  1478.           not attempt  to call the  number, rather it  will skip the
  1479.           actual call-back and go directly to the password request.
  1480.  
  1481.           *** WARNING *** TWIT ALERT! ***
  1482.               Be  very careful  about putting  phone numbers  in the
  1483.           PHONENUM.CTL file based on "Error's," invalid verification
  1484.           passwords that  look like  BBS logon  screens, "No Answer"
  1485.           errors, "Voice" errors, etc.
  1486.               Why?
  1487.               This hasn't  happened on  my system  yet, but  I could
  1488.           envision  it.  Say  some twit,  uh...  John, is  trying to
  1489.           damage Mark's reputation.  Now, John calls and uses Mark's
  1490.           phone numbers (Mark is not yet  a user on the system yet -
  1491.           he is perfectly  innocent).  John then  tries to break the
  1492.           CBV system,  causing all sorts  of errors to  log.  So, it
  1493.           looks like Mark was doing it, and you decide to lock those
  1494.           phone numbers out.  Now Mark, who never did anything wrong
  1495.           in the first place, can't log onto your board.
  1496.               I don't know if that will ever happen, but just a word
  1497.           to the wise.
  1498.  
  1499.               New users that call long distance get a message asking
  1500.           them to send  me a self-addressed  stamped envelope (SASE)
  1501.           to me.  I will then change their password and mail the new
  1502.           password back to  them.  It's slow,  but takes little time
  1503.           on my part.  I don't have their phone number, but at least
  1504.           I have an address.
  1505.  
  1506.           *** NOTE ***
  1507.               If you are using QuickBBS version 2.62 or above you will 
  1508.           need to use FIX_15.ZIP.  Due to changes made in the QuickBBS
  1509.           dorinfo.def file.  Not using it will result in incorrect baud
  1510.           rate upon return to the bbs after a correct verification.
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.                                     Page 25
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.                        CBV Version 2.26
  1532.                        Copyright (C) 1989, Jim Baldwin
  1533.  
  1534.  
  1535.                                VERSION HISTORY
  1536.  
  1537.           History of development  process, versions, and approximate
  1538.           dates.
  1539.  
  1540.           0.0 DEV       Feb 1989, started writing CBV
  1541.           0.1 alpha     Feb  1989, initial  alpha-testing on  my own
  1542.                         system.
  1543.           0.1 beta      March 1989,  added some  quick &  dirty docs
  1544.                         and set it up on Bill Castle's system.
  1545.           0.2 beta      March   1989,   added   configuration  file,
  1546.                         rewrote  call-back  module,  added  8-second
  1547.                         delay after re-connecting  to let HST modems
  1548.                         calm  down,  internals cleaned  up  and bugs
  1549.                         fixed.   Set  up on  Bob  Huson's  and Eddie
  1550.                         Enloe's board.
  1551.           0.3 beta      March  1989,  added  simple  copy protection
  1552.                         because  the   early  and   buggy  beta-test
  1553.                         versions   were   getting   passed   around.
  1554.                         Cleaned things up a little more.
  1555.           0.4 beta      April  1989, (still  labeled as  0.3 though)
  1556.                         Fixed problem  with modems  that take longer
  1557.                         than a few seconds to disconnect.  Set up on
  1558.                         Dave Ball's board.
  1559.           1.0           May 6, 1989,  removed copy protection, added
  1560.                         support for  9600 baud modems,  cleaned up a
  1561.                         few  things, wrote  this  manual, recompiled
  1562.                         under Microsoft  C 5.1  instead of  Quick C.
  1563.                         Many bugs fixed,  especially with the timing
  1564.                         functions.   Completely  rewrote  screen i/o
  1565.                         routines   to  use   BIOS  instead   of  DOS
  1566.                         (ANSI.SYS  no   longer  needed   to  display
  1567.                         colors),  added  QuickBBS-like  status line,
  1568.                         added ALT-H  to hang-up  user.  Added Serial
  1569.                         Number, Registration Number, and "Evaluation
  1570.                         Copy"  handler.    Wrote  REGISTER  program.
  1571.                         Wrote  library   construct/extract  modules,
  1572.                         added install program.   Thanks again, Bill,
  1573.                         for giving  me that  little nudge  to finish
  1574.                         this thing up.
  1575.  
  1576.           1.1           May 10, 1989,  a bug with  systems that only
  1577.                         request  one  phone number  has  been fixed.
  1578.                         The CBV would insist  that the user is using
  1579.                         a duplicate  phone number, when  in fact, it
  1580.                         was not a duplicate  number.  Thanks to Rick
  1581.                         Gould   for   pointing    out   the,   er...
  1582.                         "undocumented    feature"    <grin>.     The
  1583.                         documentation  has  been   fixed  up,  also.
  1584.                         Added  the  ability  to  specify  "user flag
  1585.                         masks" in  the CBV.CNF file.   Added a check
  1586.                         for  valid  phone  numbers  using  a  set of
  1587.                         "rules."
  1588.  
  1589.  
  1590.                                     Page 26
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.                        CBV Version 2.26
  1598.                        Copyright (C) 1989, Jim Baldwin
  1599.  
  1600.  
  1601.           1.2           May 15, 1989.
  1602.                         Bug fix:
  1603.                         Slight error in  phone number validity check
  1604.                         function  has  been  fixed.   Potential  bug
  1605.                         fixed in  call-back module  that could cause
  1606.                         modems to disconnect  after re-connecting if
  1607.                         ModemInit wasn't setup perfectly.
  1608.                         Enhancements:
  1609.                         MULTIPLE  LOCAL  AREA  CODES  NOW SUPPORTED!
  1610.                         (extended  calling).  Thanks  to  Paul Smith
  1611.                         for    the    suggestions    and    detailed
  1612.                         explanations.   Also  added  the  ability to
  1613.                         specify  that  all prefixes  for  a specific
  1614.                         area code are local.
  1615.                         Documentation revised, many parts rewritten,
  1616.                         new sections added.
  1617.                         Locking out  a user (ALT-L  or setting their
  1618.                         security level to 0) now has the same effect
  1619.                         as   entering   their   number(s)   in   the
  1620.                         PHONENUM.CTL file.  This makes the ALT-L key
  1621.                         REALLY lock a user out on a permanent basis.
  1622.                         FOSSIL port is now selectable in the CBV.CNF
  1623.                         file.
  1624.                         REGISTER program now checks to make sure the
  1625.                         city and state are entered properly.
  1626.  
  1627.           1.21          New codewords added ---  CheckNumber, DupeCheck
  1628.                         and CodeWord.
  1629.  
  1630.           1.21a         Beta Release from New Owner <<<me>>>
  1631.  
  1632.           1.22          Released official version of CBV.  Now
  1633.                         requires FIX_15 for versions 2.62 QuickBBS and
  1634.                         above.
  1635.  
  1636.           2.26          Released corrected documentation for Support
  1637.                         Board <123/10 Fido Address>, and correct address for
  1638.                         registration.
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.                                     Page 27
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.                        CBV Version 2.26
  1662.                        Copyright (C) 1989, Jim Baldwin
  1663.  
  1664.  
  1665.                               REGISTRATION FORM
  1666.  
  1667.           To register your copy of the CBV system, fill out and mail
  1668.           this form  to the following  address, or  use the REGISTER
  1669.           program to make things even easier!
  1670.  
  1671.               Jim Baldwin
  1672.               P.O. Box 70245
  1673.               Memphis, TN 38107
  1674.  
  1675.           After registering, you will  receive a Registration Number
  1676.           which will remove the "EVALUATION COPY" notices and pauses
  1677.           from  the CBV  program.  As  a  registered user,  you will
  1678.           receive update  notices regarding  future versions  of the
  1679.           CBV package,  and optionally, you  may have  your name and
  1680.           BBS number placed  on the list of  supporting users in the
  1681.           next release of the CBV documentation.
  1682.  
  1683.           Your Name_________________________________________________
  1684.  
  1685.           Company___________________________________________________
  1686.  
  1687.           Address___________________________________________________
  1688.  
  1689.           City, State, Zip__________________________________________
  1690.  
  1691.           BBS Name____________________ BBS Phone____________________
  1692.  
  1693.           Network (ie Fido)_____________ Net/Node___________________
  1694.  
  1695.           CBV Serial Number_________________  (run REGISTER program)
  1696.  
  1697.           Add your  BBS to our  list of supporting  users for future
  1698.           releases of the documentation?  [ ] Yes     [ ] No
  1699.           How long have you been running a BBS?_____________________
  1700.           Where did you get this software from?
  1701.           [ ] the author       | [ ] a bulletin board
  1702.           [ ] a friend         |     Name___________________________
  1703.           [ ] a computer club  |     Phone # _______________________
  1704.           [ ] a shareware software distributor
  1705.           [ ] other_________________________________________________
  1706.  
  1707.           What do you like most about this software?
  1708.  
  1709.           __________________________________________________________
  1710.                                                Registration  $  8.00
  1711.  
  1712.                      TN Residents add 7.75% sales tax ($.61)   ______
  1713.  
  1714.                                        Total amount enclosed  ______
  1715.  
  1716.                    Make checks payable to:  Jim Baldwin.
  1717.                Use back side for other comments/suggestions...
  1718.                                -=-THANK YOU!-=-
  1719.  
  1720.                                     Page 28
  1721.  
  1722.  
  1723.  
  1724.  
  1725.